package cn.zero.letaomallspringboot.config;

import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class SwaggerConfig {

    /**
     * 自定义 OpenAPI 文档信息（项目描述、作者、版本等）
     */
    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                // 1. 文档基础信息（必填）
                .info(new Info()
                        .title("乐淘商城 - 订单管理 API") // 接口文档标题（如项目/模块名称）
                        .description("订单模块的 CRUD 接口、分页查询、状态更新等接口文档") // 接口功能描述
                        .version("v1.0.0") // 接口版本
                        // 2. 作者信息（可选）
                        .contact(new Contact()
                                .name("开发团队") // 作者/团队名称
                                .email("dev@example.com") // 联系邮箱
                                .url("https://example.com") // 团队链接（可选）
                        )
                        // 3. 许可证信息（可选，如开源协议）
                        .license(new License()
                                .name("Apache 2.0")
                                .url("https://www.apache.org/licenses/LICENSE-2.0.html")
                        )
                );
    }
}